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Chapter 1: Introduction 



This chapter introduces you to the Blue Coat® Reporter and provides the document 
description and conventions. 

Welcome To Blue Coat Reporter 

Blue Coat Reporter analyzes Blue Coat SG access log files and presents data using over 
150 pre-defined reports. 

Reporter generates dynamic reports on demand, and it supports features such as 
zooming (or drill-down viewing) and filtering. You can also create and apply 
expression and log filters. For example, you can create filters to zoom in on the events 
for a particular address on a particular day, or to see requests to a specific content 
filtering category. Reporter allows you to navigate naturally and quickly through 
hierarchies. 

Reporter runs as its own Web server, serving its HTML pages to any Web browser 
through HTTP. Reporter is accessed through a Web browser. 

About the Document Organization 

This document is divided into the following sections and chapters: 



Chapter Title 


Description 


Chapter 1: "Introduction" 


This chapter. 


Chapter 2: "Installation" 


Provides system requirements and instructions for installing 
and launching Reporter using either Windows or Linux. 


Chapter 3: "Blue Coat Reporter Overview and 
Licensing" 


Describes the initial Reporter screen and describes how to 
enter an Enterprise License. 


Chapter 4: "Managing Profiles and User 
Accounts" 


Describes how to create Reporter profiles and user accounts, 
and how to assign reports to profiles. 


Chapter 5: "Generating and Managing 
Reports" 


Describes how to create a profile and a user account, use the 
Scheduler, set profile preferences, and generate a report. 


Chapter 6: "Configuring Profiles" 


Describes how to modify existing profiles and report 
appearances; describes how to tune databases. 


Appendix A: "Report Concepts and 
Reference" 


Provides more details about the contents of an HTML report 
page; describes concepts relating to Reporter processes; 
provides log field and report field references and matrices. 


Appendix B: "v7 Profile Reference" 


Explains how to create configuration files and apply advanced 
log filters to selectively eliminate portions of your log data 
from the statistics. 


Appendix C: "Configuration File Reference" 


Lists the Profile and Preference options. 



9 



Blue Coat Reporter Configuration and Management Guide 



Chapter Title 


Description 


Appendix D: "Using Reporter from the 
Command Line Interface" 


Explains how to use the Reporter command-line to manage 
databases, create reports, and view profile information. Also 
covers a number of run time options. 


Appendix E: "Upgrading From Reporter 7.1.x 
to 8.2.x" 


Describes how to perform initial tasks required before 
upgrading. 


Appendix F: "Copyrights" 


Lists the third party vendors licensed by Blue Coat. 



Related Blue Coat Documentation 

□ Blue Coat ProxySG Configuration and Management Suite 

□ Blue Coat ProxySG Content Policy Language Guide 

Document Conventions 

This document uses the following typeface and screenshot conventions. 

Typographical Conventions 

The following section lists the typographical and Command Line Interface (CLI) syntax 
conventions used in this manual. 

Table 1-1 . 



Conventions 



Definition 



Italics The first use of a new or Blue Coat-proprietary term. 

Courier font Command line text that appears on your administrator workstation. 

Courier Italics A command line variable that is to be substituted with a literal name 

or value pertaining to the appropriate facet of your network system. 



Procedure Conventions 

This document employs the use of screenshots (Online Help excluded) to illustrate 

procedures and convey example information. 

□ Procedure screenshots — Identified by borders and callouts, these precede numbered 
steps or a set of steps. The numbered callouts point to Reporter fields and options 
relevant to the given procedure, and correlate with the numbered steps below, which 
provide detailed explanations of the options. 

□ Figures — Identified by incremental numbering below them (no borders), figures 
provide conceptual information or completed examples of preceding procedures. 
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This chapter describes how to install and access Blue Coat Reporter on a Windows or 
Linux platform. 



Important: Before you install and run Reporter 8.3.x, be aware of the associated 
upgrade issues, such as report compatibility. If you are upgrading to Reporter 8.3.x 
from Reporter 7.1.x, (Windows only), you must perform an upgrade preparation 
procedure, which involves running a script. For upgrade information, see Appendix 
D:"About Upgrading" on page 231 or the Blue Coat Reporter 8.3.x Release Notes. 



System Requirements 

Blue Coat Reporter is a resource-intensive application. Having more disk, CPU, and 
memory than the minimum requirements improves the performance. 

Hardware Requirements 

Refer to the Specifications document located at: 
http: / / www.bluecoat.com / products / reporter. 

Software Requirements 

□ Microsoft Windows 

□ Red Hat Linux. 

Refer to the Blue Coat Reporter Release Notes for the most current list of supported 
software and versions. 

Reporter uses its own Web server — an existing Web server is not required on the 
computer where it is running. 

Browser Support 

□ Mozilla Firefox (the recommended browser) 

□ Internet Explorer® or 6.x or 7.x (IE 7.x recommended) 

While other browsers, such as Netscape®, might function properly, they are not 
supported by Blue Coat. 

Interaction With Anti-Virus Services 

Blue Coat Reporter and Anti-virus (AV) scanners running on the same servers causes 
problems with folder processing. Blue Coat recommends locating log scanning and AV 
scanning services on different servers. 

If this is not possible, you can have them co-exist on the same server, but you must 
configure the AV scanner to ignore specific Reporter folders. Reporter constantly opens 
hundreds of files for exclusive access in its folders and will fail if it cannot obtain an 
exclusive lock on a file. Configure the AV scanners to ignore the following folders: 

□ LogAnalysisInfcADatabases (or whereever the database folder resides) 
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□ LogAnalysisInfoMPC 

□ LogAnalysislnfo\Locks 

□ LogAnalysislnfo\log_formats 

□ LogAnalysislnfo\Output 

□ LogAnalysisInfcAprofiles 

□ LogAnalysislnfo\ReportCache 

□ LogAnalysislnfo\SessionChanges 

□ LogAnalysislnfo\templates 

□ LogAnalysislnfo\TempLogs 

□ LogAnalysisInfcATemporaryFiles 

□ LogAnalysislnfo\WebServerRoot 

□ LogAnalysislnfo\ (not all subdirectores, rather the root, which would ignore the files in 
this directory) 

Installation 

How you install Reporter depends on the platform: Window or Linux. 

Windows Installation 

Reporter is a standard Windows installer. 

To install Reporter using Windows: 

1. Double-click the Windows installer program to start the installer, and follow the 
installation Wizard tasks. 

2. The installation wizard prompts you to respond to a few standard installation 
questions, such as acceptance of product terms and installation location. Then the 
following dialog displays: 




Figure 2-1 . Installation question dialog. 

Because of substantial design enhances, profiles created before updating to Reporter 
8. 2. 1.0 are not compatible with this version. However, if you have created custom 
profiles, this dialog allows you to preserve those configurations to make it easier to 
customize 8.3.x profiles. 

• Click Yes to rename the LogAnalysisInfo folder (appends the current folder with 
.old), thus preserving your obsolete profile configuration files. If you click Yes, a 
verification dialog appears. Click Yes again. 

• Click No to instruct Reporter to overwrite the existing LogAnalysisInfo folder with 
the new 8.3.x version folder and not retain a copy of the previous folder. 

After Reporter is installed, automatically launches a Web browser and connects to 
Reporter. 



12 




Chapter 2: Installation 



Welcome to Blue Coat Reporter 


Please create an administrative user 


Username: 


IT_Admin 


Password: 




Re-enter password: 






| Login | 



3. The first time you launch Reporter, you are prompted to enter (thus creating) an 
administrator username and password, (see "Troubleshooting" on page 14 if you have 
created them before and forgotten them). 

4. Click Login. 



Note: For Windows users: Reporter runs as the SYSTEM user by default, which could 
restrict access to network shares or mapped drives. If you cannot access mapped network 
drives with Reporter, see "Troubleshooting the Windows Service" on page 14 for 
instructions about running Reporter as a different user. 



If you encounter other problems, see "Troubleshooting" on page 14. 

Linux Installation 

Reporter is downloaded as a gzipped tar archive file. 

To install Reporter using Linux: 

1. Transfer the gzipped tar archived file to the Linux machine that is to run Reporter. 

2. Open a shell prompt from the Linux command line. 

3. To invoke the gunzip utility and untar the file, enter the following command: 

gunzip -c (bcreport . tgz) | tar xf - 

Note: Change (bcreport . tgz) to match the name of the file you downloaded. 

4. When the archive is uncompressed and extracted, run Reporter by changing to the 
installation directory and typing the name of the executable file from the command 
line: 

cd (installation-directory) 



Note: You might need to change the filename to match the actual version you 
downloaded. 



Reporter launches, starting its own Web server on the Linux machine (using port 
8987). See "Accessing Blue Coat Reporter Locally or Remotely" below for more 
information about running Reporter. 
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Note: To run Reporter in the background, add a single ampersand (&) to the end of 
the command line that starts Reporter. This allows you to close the terminal window 
without killing Reporter. On some systems, you might also need to add nohup to the 
beginning of the command line for this to work properly. 



If you experience any installation problems, see "Troubleshooting" on page 14. 

Accessing Blue Coat Reporter Locally or Remotely 

Now that Reporter is installed, you can access it from the Windows Start menu or by 
entering the IP address or DNS name. 

To access Reporter through or Linux: 

1. Access Reporter locally by browsing to the local host IP address, which is: 

http://127.CI. 0.1 :8987/ 

2. (Optional) To access Reporter remotely, browse to the server IP address: 

http : // server_ip_or_hostname : 8 987 / 

where server_ip_or_hostname is the IP address or DNS name of the computer on 
which you installed Reporter. 

3. Enter your administrator username and password, (see "Troubleshooting" on page 14 
if you have created them before and forgotten them). 

Troubleshooting 

If Reporter does not start up (for example, if you receive a page back when you enter the 
URL or if you receive an error page), attempt the following: 

□ Verify you installed the version of Reporter that matches the computer on which you 
are running Reporter (for instance, you cannot run the Linux version of Reporter on 
Windows). 

□ Verify you downloaded Reporter in BINARY mode. 

□ In Linux, verify the Reporter program is executable. 

If you forget your username or password, you can change them: 

□ Go to the LogAnalysisInfo folder and open the users . cfg file; change the username 
and/or password and close the file. 

□ You can also delete the users. cfg file, which deletes all usernames and passwords 
from Reporter. When you launch Reporter, you are prompted to create a new 
username and password. 

Troubleshooting the Windows Service 

By default Reporter is installed as a service on Windows. It runs as the local system 
account. This account does not have access to network shares. To use network shares, you 
must change the service user to one who has permission to access the desired resources. 

On some Windows versions. Reporter cannot browse mapped network drive letters. In 
this case, directories must be specified using UNC paths. For example: 

\\servername\sharename\. 
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When run directly from the command line. Reporter displays mapped network drive 
letters. 

To update the system username/password: 

1. On the PC: 

a. Select Start > Settings > Control Panel. 

b. Double-click Administrative Tools. 

c. Double-click Services or Services and Applications (depending on the OS). 

2. Locate the Reporter service: 

a. Right-click the service and select Stop. 

b. Right-click the service and select Properties. 

c. Select Log On. 

d. Select This Account. 

e. Enter the new username/ password for the network. (You can also browse for 
the user.) 

f. Click OK. 

3. Right-click the Reporter service and select Restart. 

The next time you launch Reporter, you can to access network shares when specifying the 
directory using UNC path names. 
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This chapter describes the main Blue Coat Reporter user interface components. 

The Data Profiles/Settings Menu 

The Administrative menu appears at the left of the main administrative page. 



BlU©'OCO0t1 Re P°rterData Profiles/Settings'>wi » --i' h,.i p Lo9 .»t 


1 Data Profiles 


Scheduler 


Data Profiles 


Users 

Roles 


No data profiles exist. To view statistic reports you must create a new data profile first. 


► Settings 


Click hereto create a new data profile. 


Licensing 




Version 





Figure 3-1. The Data Profiles/Settings menu. 

The upper right corner of the header pane displays the logged-in username. As you 

navigate other Reporter pages, clicking the Data profiles/settings link next to the 

username returns you to this page. 

The Administrative menu provides basic administrative functions, as follows. 

□ Data Profiles — From this page, you can create new profiles, delete existing ones, 
edit profile configuration information, or view reports for a profile (the Show 
Reports link). See "Section A: About Data Profiles and Database Types" on page 22. 

□ Scheduler — From this page, you can create, delete, and edit scheduled tasks. For 
example, you can create a task to update all of your databases every night or to 
send a report of the previous month by e-mail on the 1st of each month. See 
"Section F: Configuring the Reporter Scheduler" on page 97 for more information. 

□ Users — From this page, you can add or remove users and change the options for 
each user. For example, you can determine which users have administrative access 
and which profiles non-admin users are permitted to view. See "Section E: Creating 
User Accounts" on page 50 

□ Roles — From this page, you can create user roles. For example, create a role that 
only contains reports that Fluman Resource personnel are concerned with, then 
assign FIR users to that role. 

□ Settings — Access to the General, Server, E-mail, and Log Settings pages. From these 
pages, configure system wide settings such as language, DNS translation, FITTPS, 
SMTP, and memory usage.. See "Section F: Configuring Reporter Preferences" on 
page 52 

□ Licensing — From this page, you can add a license or change licensing from 
Standard to Enterprise (if you are using a Trial license). See "Adding an Enterprise 
License" on page 18. 

□ Version — Displays the current Blue Coat Reporter version and build information. 
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